home *** CD-ROM | disk | FTP | other *** search
/ Aminet 13 / Aminet 13 - August 1996.iso / Aminet / mus / misc / Beatific11.lha / Beatific11 / Controller < prev    next >
Text File  |  1996-06-09  |  3KB  |  120 lines
  1. Controller
  2. ----------
  3.  
  4. If you like you can connect something to one of the computer's controller
  5. ports and Beatific can use it. Why would you want to do this?
  6.  
  7. You could wire up a gadget which sits between the output of a mixer and the
  8. computer. It could detect beats and tell Beatific when they happen. This idea
  9. was suggested by Wolfgang F. Gdrber <2e9326256@student.tuwien.ac.at>.
  10.  
  11. Or maybe you'd just like to use a joystick, joypad, or mouse instead of a
  12. keyboard.
  13.  
  14.  
  15. What to do
  16. ----------
  17.  
  18. The controller port that you use is the one used for joysticks, not the one
  19. used for mice. You know.
  20.  
  21. You can use four of the pins on this controller port to tell Beatific to do
  22. these things...
  23.  
  24.     Quit    (Amiga-Q)
  25.     Stop    (Esc)
  26.     Pause    (Space)
  27.     Start    (Return)
  28.  
  29. The pins are numbered like this when you look at the controller port from the
  30. outside...
  31.  
  32.     .-----------.
  33.     | 1 2 3 4 5 |
  34.     `. 6 7 8 9 .'
  35.       `-------'
  36.  
  37. And each pin does this...
  38.  
  39.     Pin #    Joystick    Mouse
  40.     1    Right        -.
  41.     2    Left         | Weird Mouse
  42.     3    Down         | Things
  43.     4    Up        -'
  44.     5    Fire 3        MMB
  45.     6    Fire 1        LMB
  46.     7        +5V DC
  47.     8        Ground
  48.     9    Fire 2        RMB
  49.  
  50. So wire up whatever it is to the controller port and get Beatific to use it
  51. by setting the right tool types. Your widget can use pins 7 and 8 for power
  52. and can send a pulse on any one of the other pins.
  53.  
  54. Don't send a pulse on pins 1 and 2 at the same time and don't send a pulse on
  55. pins 3 and 4 at the same time. It'll mean that Beatific will ignore both of
  56. the pulses. Use pins 5, 6, 9, and one of the others if you want to be sure.
  57.  
  58. Another thing: I'm not sure about the current/voltage/time/etc... for the
  59. pulse. If you get it wrong something expensive will probably happen to your
  60. computer. And it's all your fault when it happens, not mine.
  61.  
  62. Or you can just plug in a joystick, joypad, or mouse. If you plug in a mouse
  63. only the buttons will work. Directions will go wrong, like if you accidently
  64. use the mouse for a game which needs a joystick.
  65.  
  66.  
  67. Tool Types (again)
  68. ------------------
  69.  
  70. Four tool types tell Beatific which pins in the controller port to use...
  71.  
  72.     QUIT=<what>
  73.     STOP=<what>
  74.     PAUSE=<what>
  75.     START=<what>
  76.  
  77. <what> can be one of...
  78.  
  79.     NONE - your wossname doesn't send a pulse for this action.
  80.     A pin number - 1 to 6 or 9.
  81.     A joystick or mouse action - converted to its pin number.
  82.  
  83. The actions are...
  84.  
  85.     Pin #    Joystick    Mouse
  86.     1    RIGHT
  87.     2    LEFT
  88.     3    DOWN
  89.     4    UP
  90.     5    FIRE3        MMB
  91.     6    FIRE        LMB
  92.     9    FIRE2        RMB
  93.  
  94. Some examples are...
  95.  
  96.     QUIT=NONE
  97.     STOP=UP
  98.     PAUSE=9
  99.     START=LMB
  100.  
  101. The next tooltype is whether or not to ignore beats when stopped or paused.
  102. If it's on, use the Alt key to start listening again...
  103.  
  104.     IGNORE=<what>
  105.  
  106. <what> can be one of...
  107.  
  108.     ON, YES, or TRUE.
  109.     OFF, NO, or FALSE.
  110.  
  111.  
  112. Controls (again)
  113. ----------------
  114.  
  115. Just in case the thing you've connected can't easily stop sending beats, set
  116. the ignore thing and use the Alt key. When it's stopped or paused Beatific
  117. ignores any beats sent to it. Press the Alt key and it starts listening to
  118. them again. If you didn't have this Beatific would just start up again
  119. straight away when you stopped or paused it.
  120.